home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / gnu / dejagnu.lha / dejagnu-1.0.1 / tcl / porting.notes < prev    next >
Text File  |  1993-02-14  |  6KB  |  178 lines
  1. This file contains a collection of notes that various people have
  2. provided about porting Tcl to various machines and operating systems.
  3. I don't have personal access to any of these machines, so I make
  4. no guarantees that the notes are correct, complete, or up-to-date.
  5. In some cases, a person has volunteered to act as a contact point
  6. for questions about porting Tcl to a particular machine;  in these
  7. cases the person's name and e-mail address are listed.
  8.  
  9. ---------------------------------------------
  10. Cray machines running UNICOS:
  11. Contact: John Freeman (jlf@cray.com)
  12. ---------------------------------------------
  13.  
  14. 1. The nm command on unicos doesn't have a -p option, so I removed it
  15. from the config script without apparent harm.
  16.  
  17. diff -c -r1.1 config
  18. *** 1.1    1991/11/12 15:11:51
  19. --- config    1991/11/12 15:14:18
  20. ***************
  21. *** 57,63 ****
  22.       echo "  to set the libc variable."
  23.       exit(1)
  24.   endif
  25. ! nm -p $libc > tmp.libc
  26.   if ( $status != 0 ) then
  27.       echo "- ERROR\!\!  Nm failed to extract names of system-supplied library"
  28.       echo "  procedures from $libc.  You'll have to modify config by hand to"
  29. --- 57,63 ----
  30.       echo "  to set the libc variable."
  31.       exit(1)
  32.   endif
  33. ! nm $libc > tmp.libc
  34.   if ( $status != 0 ) then
  35.       echo "- ERROR\!\!  Nm failed to extract names of system-supplied library"
  36.       echo "  procedures from $libc.  You'll have to modify config by hand to"
  37.  
  38. 2. There is an error in the strstr function in UNICOS such that if the
  39. string to be searched is empty (""), the search will continue past the
  40. end of the string.  Because of this, the history substitution loop
  41. will sometimes run past the end of its target string and trash
  42. malloc's free list, resulting in a core dump some time later.  (As you
  43. can probably guess, this took a while to diagnose.)  I've submitted a
  44. problem report to the C library maintainers, but in the meantime here
  45. is a workaround.
  46.  
  47. -----------------------------------------------------------------
  48. diff -c1 -r1.1 tclHistory.c
  49. *** 1.1    1991/11/12 16:01:58
  50. --- tclHistory.c    1991/11/12 16:14:22
  51. ***************
  52. *** 23,24 ****
  53. --- 23,29 ----
  54.   #include "tclInt.h"
  55. + 
  56. + #ifdef _CRAY
  57. + /* There is a bug in strstr in UNICOS; this works around it. */
  58. + #define strstr(s1,s2) ((s1)?(*(s1)?strstr((s1),(s2)):0):0)
  59. + #endif _CRAY
  60.  
  61.  
  62. ---------------------------------------------
  63. HP-UX systems:
  64. ---------------------------------------------
  65.  
  66. (The comments below are leftover from older versions of Tcl and
  67. older versions of HP software;  the current versions shouldn't
  68. require any changes at all.)
  69.  
  70. 1. The #define for TCL_UNION_WAIT in tclUnix.h needs to be set to 0,
  71. not 1.  I've tried a number of techniques to get the "config" script
  72. to figure this out and set it correctly, but so far I haven't been
  73. able to make it work for HP-UX systems.
  74.  
  75. 2. It may also be useful to add the flag "-D_BSD" to CFLAGS in the
  76. Makefile, but I'm not sure this is necessary (and it may even be
  77. evil) if TCL_UNION_WAIT has been #define'd correctly.
  78.  
  79. ---------------------------------------------
  80. MIPS systems runing EP/IX:
  81. ---------------------------------------------
  82.  
  83. 1. Need to add a line "#include <bsd/sys/time.h>" in tclUnix.h.
  84.  
  85. 2. Need to add "-lbsd" into the line that makes tclTest:
  86.  
  87.     ${CC} ${CFLAGS} tclTest.o libtcl.a -lbsd -o tclTest
  88.  
  89. ---------------------------------------------
  90. IBM RS/6000 systems running AIX:
  91. ---------------------------------------------
  92.  
  93. 1. The system version of strtoul is buggy, at least under some
  94. versions of AIX.  If the expression tests fail, try forcing Tcl
  95. to use its own version of strtoul instead of the system version.
  96. To do this, first copy strtoul.c from the compat subdirectory up
  97. to the main Tcl directory.  Then modify the Makefile so that
  98. the definition for COMPAT_OBJS includes "strtoul.o".  Note:  the
  99. "config" script should now detect the buggy strtoul and substitute
  100. Tcl's version automatically.
  101.  
  102. 2. You may have to comment out the declaration of open in tclUnix.h.
  103.  
  104. 3. You may need to add "-D_BSD -lbsd" to the CFLAGS definition.  This
  105. causes the system include files to look like BSD include files and
  106. causes C library routines to act like bsd library routines.  Without
  107. this, the system may choke on "struct wait".
  108.  
  109. ---------------------------------------------
  110. AT&T 4.03 OS:
  111. ---------------------------------------------
  112.  
  113. Machine: i386/33Mhz i387 32k Cache 16MByte 
  114. OS: AT&T SYSV Release 4 Version 3
  115. X: X11R5 fixlevel 9
  116. Xserver: X386 1.2
  117.  
  118. 1. Change the Tk Makefile as follows:
  119. XLIB            = -lX11
  120.     should be changed to:
  121. XLIB            = -lX11 -lsocket -lnsl
  122.  
  123. 2. Change the Tcl "config" script as follows:
  124. set libc="/lib/libc.a"
  125.     should be changed to:
  126. set libc="/usr/ccs/lib/libc.a"
  127.  
  128. -------------------------------------------------------
  129. Motorola MPC's running UNIX System V/88 Release R32V2:
  130. -------------------------------------------------------
  131.  
  132. 1.  Tcl should build without any modifications to sources, but csh
  133. isn't supplied with the operating system so you'll have to find and
  134. use the public-domain tcsh.
  135.  
  136. -------------------------------------------------------
  137. Silicon Graphics systems:
  138. -------------------------------------------------------
  139.  
  140. 1. In tcl/tclUnix.h, add the following around the fseek and lseek declarations:
  141.  
  142. #if !defined(__sgi)
  143. #endif
  144.  
  145. 2. Append -ansiposix to the CC variable in the Makefile. The compiler,
  146.    by default, is ANSI C with extensions, but doesn't define __STDC__ to obey
  147.    a strict reading of the ANSI standard. -ansiposix disables the extensions
  148.    and defines __STDC__.
  149.  
  150. 3. Comment out the ranlib line in the Makefile.
  151.  
  152. ---------------------------------------------
  153. NeXT machines running NeXTStep 2.1:
  154. ---------------------------------------------
  155.  
  156. 1. Change the "libc" definition in the config file to
  157.     set libc="/lib/libsys_s.a"
  158.  
  159. 2. Several of the "format" and "scan" tests will fail, but these are
  160. all minor nits stemming from imperfect POSIX compliance in the NeXT
  161. C library procedures.  The errors are unlikely to affect any Tcl
  162. applications.
  163.  
  164. -------------------------------------------------
  165. ISC 2.2 UNIX (using standard ATT SYSV compiler):
  166. -------------------------------------------------
  167.  
  168. In Makefile, change
  169.  
  170. CFLAGS =      -g -I. -DTCL_LIBRARY=\"${TCL_LIBRARY}\"
  171.  
  172. to
  173.  
  174. CFLAGS =      -g -I. -DPOSIX_JC -DTCL_LIBRARY=\"${TCL_LIBRARY}\"
  175.  
  176. This brings in the typedef for pid_t, which is needed for
  177. /usr/include/sys/wait.h in tclUnix.h.
  178.